"""笔记分享模块的URL路由配置

定义笔记分享相关的API路由。
"""

from django.urls import path, include
from rest_framework.routers import DefaultRouter

from .views import (
    SharedNoteViewSet,
    SharedFolderViewSet,
    ShareCommentViewSet,
    ShareAccessViewSet
)

app_name = 'sharing'

# 创建路由器
router = DefaultRouter()
router.register(r'shares', SharedNoteViewSet, basename='share')
router.register(r'folders', SharedFolderViewSet, basename='shared-folder')
router.register(r'comments', ShareCommentViewSet, basename='comment')
router.register(r'access', ShareAccessViewSet, basename='access')

urlpatterns = [
    # 包含路由器生成的URL
    path('', include(router.urls)),
]

# API路由说明：
# 
# 分享管理：
# GET    /api/v1/shares/               - 获取分享列表
# POST   /api/v1/shares/               - 创建分享
# GET    /api/v1/shares/{id}/          - 获取分享详情
# PUT    /api/v1/shares/{id}/          - 更新分享设置
# DELETE /api/v1/shares/{id}/          - 删除分享
# GET    /api/v1/shares/public_shares/ - 获取公开分享列表
# GET    /api/v1/shares/{token}/access/ - 通过token访问分享
# GET    /api/v1/shares/{id}/statistics/ - 获取分享统计
# 
# 评论管理：
# GET    /api/v1/comments/             - 获取评论列表
# POST   /api/v1/comments/             - 创建评论
# POST   /api/v1/comments/{id}/like/   - 点赞评论
# POST   /api/v1/comments/{id}/report/ - 举报评论
# 
# 访问记录：
# GET    /api/v1/access/               - 获取访问记录列表